Class pyglet.media.Listener

The listener properties for positional audio.

You can obtain the singleton instance of this class as pyglet.media.listener.

Properties

float	volume The master volume for sound playback.
3-tuple of float	position The position of the listener in 3D space.
3-tuple of float	forward_orientation A vector giving the direction the listener is facing.
3-tuple of float	up_orientation A vector giving the "up" orientation of the listener.

Property Details

volume

The master volume for sound playback.

All sound volumes are multiplied by this master volume before being played. A value of 0 will silence playback (but still consume resources). The nominal volume is 1.0.

Type:: float

position

The position of the listener in 3D space.

The position is given as a tuple of floats (x, y, z). The unit defaults to meters, but can be modified with the listener properties.

Type:: 3-tuple of float

forward_orientation

A vector giving the direction the listener is facing.

The orientation is given as a tuple of floats (x, y, z), and has no unit. The forward orientation should be orthogonal to the up orientation.

Type:: 3-tuple of float

up_orientation

A vector giving the "up" orientation of the listener.

The orientation is given as a tuple of floats (x, y, z), and has no unit. The up orientation should be orthogonal to the forward orientation.

Type:: 3-tuple of float